Skip to content

Translate 'Coordinates' to Portuguese - #509

Merged
gabifs merged 2 commits into
javascript-tutorial:masterfrom
diogoosz:translate-coordinates
Nov 22, 2026
Merged

gabifs merged 2 commits into
javascript-tutorial:masterfrom
diogoosz:translate-coordinates

Conversation

@diogoosz

@diogoosz diogoosz commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

Resumo

Traduz o artigo "Coordinates" para o português, incluindo os 4 exercícios desta pasta e o handler de demonstração em head.html.

Os SVGs (coordinates.svg, coordinates-negative.svg, document-and-window-coordinates-scrolled.svg) contêm apenas identificadores de propriedades do DOMRect/coordenadas (x, y, top, left, pageX, clientY etc.), por isso ficaram como estão. O texto de preenchimento "Lorem ipsum" foi mantido em latim, conforme a convenção; a piada em blockquote foi traduzida, já que é conteúdo legível de fato, mostrado nas demos dos exercícios.

Conforme comentado na #1.

Plano de teste

  • Diff de todos os trechos de código (code spans) entre o original em inglês e a tradução.
  • Grep em busca de falsos cognatos conhecidos e registro informal.
  • Confirmação de que nenhum SVG foi alterado (git diff --stat -- '*.svg').
  • Releitura manual completa para checar sentido e concordância.

Includes the 4 exercise subfolders and head.html's demo handler. SVGs
(coordinates.svg, coordinates-negative.svg,
document-and-window-coordinates-scrolled.svg) contain only DOMRect/
coordinate property identifiers (x, y, top, left, pageX, clientY, etc.),
so left untouched. The Lorem ipsum filler text is kept in Latin per
convention; the joke blockquote was translated since it's genuine
readable content shown in the exercise demos.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
As coordenadas relativas ao documento começam a partir do canto superior-esquerdo do documento, não da janela.

In CSS, window coordinates correspond to `position:fixed`, while document coordinates are similar to `position:absolute` on top.
No CSS, as coordenadas da janela correspondem a `position:fixed`, enquanto as coordenadas do documento são parecidas com `position:absolute` no topo.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Importante: aqui o "on top" do original não quer dizer "no topo" da página, e sim "no nível superior", ou seja, um position:absolute aplicado diretamente na raiz do documento (como o próprio artigo diz no início: "parecido com position:absolute na raiz do documento"). Do jeito que está, o leitor pode entender que se trata de um elemento posicionado no alto da página. Sugestão:

Suggested change
No CSS, as coordenadas da janela correspondem a `position:fixed`, enquanto as coordenadas do documento são parecidas com `position:absolute` no topo.
No CSS, as coordenadas da janela correspondem a `position:fixed`, enquanto as coordenadas do documento são parecidas com `position:absolute` aplicado no nível superior do documento.

Comment on lines +207 to +208
- `pageY` = `clientY` + altura da parte vertical rolada para fora do documento.
- `pageX` = `clientX` + largura da parte horizontal rolada para fora do documento.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Importante: "rolada para fora do documento" pode ser lido como se essa parte saísse do documento, o que muda o sentido. O original fala da parte do documento que, com a rolagem, saiu da área visível da janela. Sugestão:

Suggested change
- `pageY` = `clientY` + altura da parte vertical rolada para fora do documento.
- `pageX` = `clientX` + largura da parte horizontal rolada para fora do documento.
- `pageY` = `clientY` + altura da parte vertical do documento que foi rolada para fora da área visível.
- `pageX` = `clientX` + largura da parte horizontal do documento que foi rolada para fora da área visível.

Pelo mesmo motivo, a linha 19 ("agora rolado para fora") ficaria mais clara como "agora fora da área visível".

// add it for 5 seconds in the document
let message = createMessageUnder(elem, 'Hello, world!');
// Uso:
// adiciona ela por 5 segundos no documento

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Opcional: na norma escrita, o pronome oblíquo é o mais adequado como objeto direto ("adiciona-a"), e o verbo "adicionar" pede a preposição "a" ("ao documento"). Sugestão:

Suggested change
// adiciona ela por 5 segundos no documento
// adiciona-a ao documento por 5 segundos

Os cantos externos são basicamente o que obtemos de [elem.getBoundingClientRect()](https://developer.mozilla.org/en-US/docs/DOM/element.getBoundingClientRect).

Coordinates of the upper-left corner `answer1` and the bottom-right corner `answer2`:
Coordenadas do canto superior-esquerdo `answer1` e do canto inferior-direito `answer2`:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Opcional: em português, os adjetivos de posição como estes costumam ser escritos sem hífen: "canto superior esquerdo", "canto inferior direito". A mesma forma com hífen aparece em outras partes da tradução: nos títulos deste arquivo (linhas 14 e 22), em task.md desta tarefa (linhas 17 a 20) e em article.md (linhas 80, 102 e 198). Sugestão para esta linha:

Suggested change
Coordenadas do canto superior-esquerdo `answer1` e do canto inferior-direito `answer2`:
Coordenadas do canto superior esquerdo `answer1` e do canto inferior direito `answer2`:

- Fix meaning: "position:absolute on top" means applied at the
  document's top level, not an element positioned at the top of
  the page
- Fix meaning: the "scrolled-out" part is the part that left the
  visible area, not a part that left the document itself
- Remove hyphens from position terms ("superior esquerdo", "inferior
  direito"), which is the standard unhyphenated PT-BR form
- Use the oblique pronoun "adiciona-a" with its required preposition

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@diogoosz

Copy link
Copy Markdown
Contributor Author

Obrigado pela revisão, @gabifs! Corrigido:

  • "position:absolute on top" ajustado pro sentido correto (nível superior do documento, não topo da página)
  • "parte rolada pra fora" ajustado pra deixar claro que é a área visível, não o documento
  • Hífen removido de "superior esquerdo"/"inferior direito"
  • Pronome oblíquo "adiciona-a" com a preposição correta

@gabifs gabifs left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Todas as sugestões foram aplicadas. Obrigado pela tradução, @diogoosz! 🎉

@gabifs
gabifs merged commit 4a4c6e1 into javascript-tutorial:master Nov 22, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants